Inside Macintosh: QuickDraw GX Objects /

Chapter 2 - Shape Objects / Shape Objects Reference

Functions / Manipulating Shape Object Properties

GXSetShapeGeometry

You can use the GXSetShapeGeometry function to copy the geometry from one shape object to another.

void GXSetShapeGeometry(gxShape target, gxShape geometry);

target

A reference to the shape to copy the new geometry into.

geometry

A reference to the shape to copy the new geometry from.

DESCRIPTION

For two shape objects with the same shape type, the GXSetShapeGeometry function copies the geometry from the shape referenced by the geometry parameter to the shape referenced by the target parameter. If the type of the shape referenced in the geometry parameter is different from the type of the target shape, the target shape becomes the geometry shape's type.

ERRORS, WARNINGS, AND NOTICES

Errors
out_of_memory
shape_is_nil
picture_cannot_contain_itself
shape_access_not_allowed	(debugging version)

SEE ALSO

To directly manipulate the contents of a shape's geometry, see the section "Directly Manipulating a Shape's Geometry" beginning on page 2-34; see also the descriptions of the GXLockShape, GXUnlockShape, GXGetShapeStructure, and GXChangedShape functions, beginning on page 2-80.

Specific methods for setting and manipulating the geometries of graphic shapes are described in Inside Macintosh: QuickDraw GX Graphics. Methods for setting and manipulating the geometries of typographic shapes are described in Inside Macintosh: QuickDraw GX Typography.